home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / video / pictetri.src / pictetri / pictetris-src / jlib / targets.txt < prev   
Text File  |  1995-10-02  |  8KB  |  162 lines
  1.  
  2.  
  3.                                    JLib
  4.  
  5.                             Target Information.
  6.  
  7.      Copyright (C) 1995 Jonathan Paul Griffiths.  All Rights Reserved.
  8.  
  9.  
  10.  
  11.                           Last Updated: 02/10/95
  12.  
  13.  
  14. Introduction
  15.  
  16. This file is intended to detail each of the targets available for Jlib. 
  17. The peculiarities of the target may limit or change the expected behaviour
  18. of any of the library functions.  Any such behaviour should be noted here.
  19.  
  20. I hope to encourage people to add targets as they wish,  as each added
  21. target makes the library potentially more useful.  So if you see a target here
  22. that isn't fully functional or lacks a lot of functions,  be patient. 
  23. Someone will be adding functionality somewhere.  If you want to contribute a
  24. target,  but only have some of the functions done,  contribute it anyway and
  25. let someone else finish it or contribute to it also.
  26.  
  27. Each target is listed with its author(s),  a description,  and details about
  28. compiling for it plus other anomalies.
  29.  
  30.  
  31. NOTE: Compiling for multiple targets:
  32.   If you want to compile for more than one target often on your machine,  It
  33. will get very annoying to have to constantly recompile.  I recommend compiling
  34. each targets library and renaming them to something meaningful.  Remember
  35. to keep the include files seperate also, or you might end up in trouble!
  36. To do this you will have to manually include the header files at compile
  37. time,  or define the target on the command line.  I will try to include more
  38. details on this in a future release.
  39.  
  40.  
  41. Targets:
  42.  
  43. DJGPP_DPMI_COMPLIANT : MODE_13H
  44.  
  45. Author:      Jonathan Griffiths
  46. Description: DJGPP compiler with IBM mode 13h graphics.  320 x 200 x 256
  47.              screen mode with 1 page.  Seems quite fast even with crappy
  48.              ISA cards (like mine!).  
  49. Details:     Must compile with -lpc on the command line after -lj as this
  50.              Target uses functions from libpc.  Executables will run under
  51.              dos boxes in windows and os/2 (os/2 untested) as well as dos.
  52.              This mode is fully compatable with djgpp V2.  Keyboard support
  53.              is only available under djgpp v2 because interrupts are too
  54.              unreliable under V1.  You should move to V2 as soon as
  55.              possible.
  56. Anomalies:   This was the first target I wrote so it's anomalies are
  57.              *features* of the library.
  58.              V2 fixes most of go32's interrupt bugs,  but it still might
  59.              suffer if your program pages a lot.  Stay tuned for a solution.
  60. Missing:     Joystick routines to satisfy jinput.h
  61.              
  62.         
  63.  
  64.  
  65. DJGPP_DPMI_COMPLIANT : GRX_640x480x256
  66.  
  67. Author:      Jonathan Griffiths
  68. Description: DJGPP compiler with 1 page,  640x480 256 color graphics through
  69.              libgrx.  Runs fairly slow on ISA cards but should be aceptable
  70.              with local bus cards.
  71. Details:     Must compile with -lpc and -lgrx on the command line after -lj.
  72.              Cheats a little to draw to the screen.  I came up with this
  73.              target in a couple of days so it's a little rough.  This isn't
  74.              dpmi compliant becuase libgrx version 1 isn't.If you have a driver
  75.              for your card it might speed up further still.
  76.              Remember that libgrx is subject to a license for commercial use! 
  77. Missing:     Keyboard and joystick support to satisfy jinput.h - these are
  78.              probably not going to arrive as I'm concentrating on grx v2.
  79.  
  80.  
  81.  
  82. DJGPP_DPMI_COMPLIANT : GRX2_320x200x256, GRX2_640x480x256, GRX2_800x600x256
  83.  
  84. Author:      Jonathan Griffiths
  85. Description: DJGPP compiler with various 256 color graphics modes through
  86.              libgrx V2.  Runs fairly slow on ISA cards but should be aceptable
  87.              with local bus cards.  This is a multiple target - the same 
  88.              target code provides the three different targets.
  89. Details:     Must compile with -lpc and -lgrx20 on the command line after -lj.
  90.              This is a bit of a hack, so it's a little rough,  but it is
  91.              dpmi compliant (ie runs under windows and os/2).If you have a
  92.              driver for your card it will probably run at a good speed. 
  93.              Dont forget to check the copyright etc of the new version!
  94.              I'm expecting to create a new,  vesa based target for dos that
  95.              wont be subject to any licensing conditions.  Until then grx
  96.              makes a good development environment.
  97. Missing:     Keyboard and joystick support to satisfy jinput.h
  98.              
  99.  
  100.  
  101.  
  102. LINUX_SVGALIB : MODE_13H
  103.  
  104. Author:      Jonathan Griffiths
  105. Description: Linux with svgalib. mode 13h,  looks just like DJGPP 13h but it
  106.              seems to run just a tad faster and is more fun to develop with. 
  107. Details:     Uses svgalib for palette and mode setting but draws to the screen
  108.              itself.  Uses vgamouse package (comes with svgalib) for mouse.
  109.              Must link with -lvga and -lvgagl to compile.  Rather crappy
  110.              looking mouse cursor due to speed interest (+ lack of talent ;) )
  111.              Mike Manly has figured out how to compile it as a shared library. 
  112.              look in source/target/linux13h/makeshar for details.  This
  113.              target uses the rawkeyboard package (came with svgalib) for
  114.              keyboard input.
  115. Missing:     Joystick routines to satisfy jinput.h
  116.  
  117.        
  118.  
  119.  
  120. LINUX_GRX2 : GRX2_320x200x256, GRX2_640x480x256, GRX2_800x600x256
  121.  
  122. Author:      Jonathan Griffiths
  123. Description: Linux  with various 256 color graphics modes through
  124.              libgrx V2.  Runs fairly slow on ISA cards but should be aceptable
  125.              with local bus cards.  This is a multiple target - the same 
  126.              target code provides the three different targets.
  127. Details:     Must compile with -lgrx20 then -lvga on the command line after
  128.              -lj. This is a bit of a hack, so it's a little rough.  Your card
  129.              needs to be supported by svgalib and/or libgrx to use this
  130.              target.  You also have to get hold of grx2 and compile it.  You
  131.              can get grx2 for linux and dos from http://www.delorie.com .
  132.              Dont forget to check the copyright etc of the new version!
  133.              I'm expecting to create a new,  gl based target for linux that
  134.              wont be subject to any licensing conditions.  Until then grx
  135.              makes a good development environment.
  136. Missing:     Joystick support to satisfy jinput.h
  137.  
  138.  
  139.  
  140. X_WINDOWS : X_320x200x256
  141.  
  142. Author:      Mike Manly
  143. Description: Hopefully generic X based target.  Currently being developed
  144.              under Linux/X.  Has run successfully on a SPARC!
  145. Details:     Please do not ask me (Jon) when this target will be finished - I
  146.              do not have X on my linux box and so can't contribute.
  147.              You will probably have to edit the makefile to compile under
  148.              non-linux based x's.  It should be pretty clear what to do.
  149.              This target is under development - expect bugs until someone
  150.              says not to.
  151.              There seems to be no reason why this target couldn't be
  152.              expanded to provide other resolutions once its up and running.
  153. Anomilies:   X doesn't preallocate colors,  so always load a palette or set
  154.              the colors you will be using,  otherwise all you may see is
  155.              black. The lack of input means that the utes dont work at the
  156.              moment,  and demo10 doesn't either,  but the file I/O stuff does.
  157.              There may be an endian-related problem in the compression code,
  158.              but decompression works very well.
  159. Missing:     screen_fill() and screen_clear() to satisfy jscreen.h
  160.              Keyboard, mouse and joystick routines to satisfy jinput.h
  161.         
  162.